package org.ztr.yanai.blog.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.ztr.yanai.blog.dto.CreatePostDTO;
import org.ztr.yanai.blog.dto.PageRequestDTO;
import org.ztr.yanai.blog.dto.UpdatePostDTO;
import org.ztr.yanai.blog.entity.Post;
import org.ztr.yanai.blog.enums.PostStatusEnum;

import java.util.List;

/**
 * @Author: ZhaoTR
 * @Date: Created in 2025/11/22 10:00
 * @Description: 文章服务接口
 * @Version: 1.0
 */
public interface PostService {
    
    /**
     * 创建文章
     */
    Post createPost(CreatePostDTO createPostDTO);
    
    /**
     * 内部使用
     */
    boolean createPost(Post post);
    
    /**
     * 根据ID删除文章（逻辑删除）
     */
    void deletePostById(Long id);
    
    /**
     * 根据ID获取文章（带作者信息）
     */
    Post getPostByIdWithAuthor(Long id);
    
    /**
     * 根据ID获取文章
     */
    Post getPostById(Long id);
    
    /**
     * 分页查询文章
     */
    Page<Post> listPostsByPage(PageRequestDTO pageRequest, PostStatusEnum status);
    
    /**
     * 分页查询（内部使用）
     */
    Page<Post> listPostsByPage(int pageNum, int pageSize, QueryWrapper<Post> wrapper);
    
    /**
     * 更新文章
     */
    Post updatePostInfo(UpdatePostDTO updatePostDTO);
    
    /**
     * 更新文章（内部使用）
     */
    boolean updatePost(Post post);
    
    /**
     * 批量更新文章状态
     */
    void batchUpdatePostStatus(List<Long> postIds, PostStatusEnum status);
    
    /**
     * 增加文章浏览量
     */
    boolean increaseViews(Long postId);
}
